Skip to content

docs(lstk hotfix): update CLI reference to v0.22.1 - #877

Open
gtsiolis wants to merge 1 commit into
mainfrom
claude/hopeful-babbage-f726qj
Open

docs(lstk hotfix): update CLI reference to v0.22.1#877
gtsiolis wants to merge 1 commit into
mainfrom
claude/hopeful-babbage-f726qj

Conversation

@gtsiolis

Copy link
Copy Markdown
Member

Brings the lstk CLI reference up to date with the v0.22.1 release. The docs were last synced at v0.19.0 (#830), so this catches up the full v0.20.0..v0.22.1 backlog.

Files in scope (no shared lstk components exist, so each page carries its own reference content):

  • src/content/docs/aws/developer-tools/running-localstack/lstk.mdx
  • src/content/docs/azure/developer-tools/lstk.mdx

The two pages are near-identical and received the same edits.

What changed

Corrected (stale):

  • Auth-token precedenceLOCALSTACK_AUTH_TOKEN now takes precedence over a token stored in the keyring (reversed in lstk v0.21.0). The Authentication section and the environment-variable table previously stated the keyring wins.

Added (v0.20.0v0.22.1):

  • Targeting an external emulator — new section for the global --endpoint-url flag and LSTK_ENDPOINT_URL env var (with AWS_ENDPOINT_URL as a lower-priority synonym): scheme preservation for https:// ephemeral instances, emulator-type auto-detection, and the lists of commands that accept vs. reject an endpoint. Added rows to the Global options and environment-variable tables.
  • --account on lstk aws — new "Selecting the account" subsection and an options-table row (12-digit rule, AWS_ACCESS_KEY_ID fallback), noting terraform/sam share the flag and cdk rejects it.
  • container_name and expose_ports config keys — added to the default config sample and the field-reference table, plus a new "Exposing extra ports" subsection.
  • snapshot versions subcommand and version-pinned pod:<name>:<version> refs on load/show (with the note that save/remove/versions/s3:// reject a version suffix).
  • Container-runtime discovery — documented DOCKER_CONTEXT and Rancher Desktop / Podman / Lima detection alongside the resolution order.
  • lstk aws <TAB> completion note in the Shell completions section.

Review

Advisable.

  • The auth-token precedence correction is a user-facing behavior change worth a glance to confirm it reads as intended.
  • The new Targeting an external emulator and account-selection wording is drawn from the CLI's own help and source; a quick skim would be welcome.

Closes DOC-412

Cc @localstack/devx for visibility and any corrections.


Generated by Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: e280d5b
Status: ✅  Deploy successful!
Preview URL: https://50e39097.localstack-docs.pages.dev
Branch Preview URL: https://claude-hopeful-babbage-f726q.localstack-docs.pages.dev

View logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant